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DATABASE ITEM VERSIONING 

FIELD OF THE INVENTION 
This invention relates generally to databases such as Structured Query 
5 Language (SQL) databases, and more particularly to the versioning of items such 
as text-stream stored procedures (SP's) of such databases. 

BACKGROUND OF THE INVENTION 
Databases have become increasingly popular and important in today's 
computerized world. While there are many different types of databases, one 
10 common database is the Structured Query Language (SQL) database. SQL is a 
language used to interrogate and process data in a relational database; SQL 
commands can be used to interactively work with a database or can be embedded 
within a programming language to interface to a database. Programming 
extensions to SQL have turned it into a full-blown database programming 
15 language. 

Within a database (DB), a stored procedure (SP) is a SQL program that is 
stored in the database, and which is executed by calling it directly from a client 
or from a database trigger. When the SQL procedure is stored in the database, 
for example, it does not have to be replicated in each client. This saves 

20 programming effort, especially when different client user interfaces and 

development systems are used. A stored procedure can be viewed as a standard 
computer program in some respects, with one important difference: while 
standard computer programs are usually stored as one or more files on a storage 
such as a hard disk drive, a stored procedure is not stored as a separate file or 

25 files, but rather as text and binary streams within the database itself. 

Enterprise (viz., wide-scale) SQL database developers and administrators 
commonly build mission-critical systems, the failure of which can be 
catastrophic. Therefore, they are protective of the code, such as stored 
procedures, that exist on both production and development databases. To store 
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their code in such a manner as to ensure protection, developers usually use basic 
files, and then utilize long compile scripts to execute them and create their 
databases. This is less than desirable, however, since ultimately the database 
itself stores the code as a binary stream, as has been described. 
5 Thus, once the databases are in production, anyone with system 

administrator permission can change code such as stored procedures, without any 
historical record as to what changes have been made. Bugs and errors 
introduced into the procedures, for example, may be difficult to trace. 
Furthermore, the database administrator is unable to examine how the code has 
1 0 changed over time. For these and other reasons, there is a need for the present 
invention. 

SUMMARY OF THE INVENTION 
The invention relates to the versioning of items such as stored procedures 
in databases. In one embodiment, a system includes a program such as an editor, 

15 a database, a source code control (SCC) system, and a mechanism. An editor 
program provides for the editing of an item such as a stored procedure of a 
database such as a SQL database. The database includes the stored procedure 
(for example, a version of the stored procedure), and the source code control 
system stores versions of the stored procedure. The mechanism provides for the 

2 0 checking in and checking out of the stored procedures. Besides stored 

procedures, the invention is applicable to any other item of databases, including 
but not limited to: views, triggers, constraints, persisted queries and scripts for 
creating any database object, such as tables, indexes, domains, etc., as those of 
ordinary skill within the art can appreciate. 

25 In this manner, at least some embodiments of the invention provide for 

advantages not found in the prior art. For example, the mechanism that provides 
for checking in and checking out of the stored procedures of the database 
provides for effective versioning of the stored procedures. The mechanism 
keeps track of users who wish to edit the stored procedures, and once they have 
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been changed, the mechanism keeps track of the changes that have been made to 
the stored procedures. Thus, when a bug or error has been introduced into a 
stored procedure can be determined, and the database administrator is able to 
determine the history of changes made to a particular stored procedure. 
5 BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 shows a computer in conjunction with which embodiments of the 
invention may be practiced; 

FIG. 2 shows a diagram of a computerized system in accordance with an 
embodiment of the invention; 

10 FIG. 3 shows a flowchart of a check-out method according to an 

embodiment of the invention; and, 

FIG. 4 shows a flowchart of a check-in method according to an 
embodiment of the invention. 

DETAILED DESCRIPTION OF THE INVENTION 

15 In the following detailed description of exemplary embodiments of the 

invention, reference is made to the accompanying drawings which form a part 
hereof, and in which is shown by way of illustration specific exemplary 
embodiments in which the invention may be practiced. These embodiments are 
described in sufficient detail to enable those skilled in the art to practice the 

2 0 invention, and it is to be understood that other embodiments may be utilized and 
that logical, mechanical, electrical and other changes may be made without 
departing from the spirit or scope of the present invention. The following 
detailed description is, therefore, not to be taken in a limiting sense, and the 
scope of the present invention is defined only by the appended claims. 

2 5 For example, the following detailed description is provided in relation to 

database stored procedures. However, as those of ordinary skill within the art 
can appreciate, the invention is not limited to database items that are stored 
procedures, but can be applied to any other type of database items. Such items 
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include, but are not limited to, views, triggers, constraints, persisted queries and 
scripts for creating any database object, such as tables, indexes, domains, etc. 

Some portions of the detailed descriptions which follow are presented in 
terms of algorithms and symbolic representations of operations on data bits 
5 within a computer memory. These algorithmic descriptions and representations 
are the means used by those skilled in the data processing arts to most effectively 
convey the substance of their work to others skilled in the art. An algorithm is 
here, and generally, conceived to be a self-consistent sequence of steps leading 
to a desired result. The steps are those requiring physical manipulations of 

1 0 physical quantities. Usually, though not necessarily, these quantities take the 
form of electrical or magnetic signals capable of being stored, transferred, 
combined, compared, and otherwise manipulated. It has proven convenient at 
times, principally for reasons of common usage, to refer to these signals as bits, 
values, elements, symbols, characters, terms, numbers, or the like. It should be 

15 borne in mind, however, that all of these and similar terms are to be associated 
with the appropriate physical quantities and are merely convenient labels applied 
to these quantities. Unless specifically stated otherwise as apparent from the 
following discussions, it is appreciated that throughout the present invention, 
discussions utilizing terms such as "processing" or "computing" or "calculating" 

2 0 or "determining" or "displaying" or the like, refer to the action and processes of 
a computer system, or similar electronic computing device, that manipulates and 
transforms data represented as physical (electronic) quantities within the 
computer system's registers and memories into other data similarly represented 
as physical quantities within the computer system memories or registers or other 

2 5 such information storage, transmission or display devices. 

Computer 

Referring to FIG. I, a diagram of the hardware and operating 
environment in conjunction with which embodiments of the invention may be 
practiced is shown. The description of FIG. 1 is intended to provide a brief, 
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general description of suitable computer hardware and a suitable computing 

environment in conjunction with which the invention may be implemented. 

Although not required, the invention is described in the general context of 

computer-executable instructions, such as program modules, being executed by a 
5 computer, such as a personal computer. Generally, program modules include 

routines, programs, objects, components, data structures, etc., that perform 

particular tasks or implement particular abstract data types. 

Moreover, those skilled in the art will appreciate that the invention may 

be practiced with other computer system configurations, including hand-held 
1 0 devices, multiprocessor systems, microprocessor-based or programmable 

consumer electronics, network PC's, minicomputers, mainframe computers, and 

the like. The invention may also be practiced in distributed computing 

environments where tasks are performed by remote processing devices that are 

linked through a communications network. In a distributed computing 
15 environment, program modules may be located in both local and remote memory 

storage devices. 

The exemplary hardware and operating environment of FIG. 1 for 
implementing the invention includes a general purpose computing device in the 
form of a computer 20, including a processing unit 21, a system memory 22, and 

20 a system bus 23 that operatively couples various system components include the 
system memory to the processing unit 21 . There may be only one or there may 
be more than one processing unit 21, such that the processor of computer 20 
comprises a single central-processing unit (CPU), or a plurality of processing 
units, commonly referred to as a parallel processing environment. The computer 

25 20 may be a conventional computer, a distributed computer, or any other type of 
computer; the invention is not so limited. 

The system bus 23 may be any of several types of bus structures 
including a memory bus or memory controller, a peripheral bus, and a local bus 
using any of a variety of bus architectures. The system memory may also be 

5 
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referred to as simply the memory, and includes read only memory (ROM) 24 and 
random access memory (RAM) 25. A basic input/output system (BIOS) 26, 
containing the basic routines that help to transfer information between elements 
within the computer 20, such as during start-up, is stored in ROM 24. The 
5 computer 20 further includes a hard disk drive 27 for reading from and writing to 
a hard disk, not shown, a magnetic disk drive 28 for reading from or writing to a 
removable magnetic disk 29, and an optical disk drive 30 for reading from or 
writing to a removable optical disk 31 such as a CD ROM or other optical media 
The hard disk drive 27, magnetic disk drive 28, and optical disk drive 30 
10 are connected to the system bus 23 by a hard disk drive interface 32, a magnetic 
disk drive interface 33, and an optical disk drive interface 34, respectively. The 
drives and their associated computer-readable media provide nonvolatile storage 
of computer-readable instructions, data structures, program modules and other 
data for the computer 20. It should be appreciated by those skilled in the art that 
1 5 any type of computer-readable media which can store data that is accessible by a 
computer, such as magnetic cassettes, flash memory cards, digital video disks, 
Bernoulli cartridges, random access memories (RAMs), read only memories 
(ROMs), and the like, may be used in the exemplary operating environment. 

A number of program modules may be stored on the hard disk, magnetic 
2 0 disk 29, optical disk 3 1, ROM 24, or RAM 25, including an operating system 35, 
one or more application programs 36, other program modules 37, and program 
data 38. A user may enter commands and information into the personal 
computer 20 through input devices such as a keyboard 40 and pointing device 
42. Other input devices (not shown) may include a microphone, joystick, game 
2 5 pad, satellite dish, scanner, or the like. These and other input devices are often 
connected to the processing unit 21 through a serial port interface 46 that is 
coupled to the system bus, but may be connected by other interfaces, such as a 
parallel port, game port, or a universal serial bus (USB). A monitor 47 or other 
type of display device is also connected to the system bus 23 via an interface, 
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such as a video adapter 48. In addition to the monitor, computers typically 
include other peripheral output devices (not shown), such as speakers and 
printers. 

The computer 20 may operate in a networked environment using logical 
5 connections to one or more remote computers, such as remote computer 49. 

These logical connections are achieved by a communication device coupled to or 
a part of the computer 20; the invention is not limited to a particular type of 
communications device. The remote computer 49 may be another computer, a 
server, a router, a network PC, a client, a peer device or other common network 
10 node, and typically includes many or all of the elements described above relative 
to the computer 20, although only a memory storage device 50 has been 
illustrated in FIG. 1. The logical connections depicted in FIG. 1 include a local- 
area network (LAN) 51 and a wide-area network (WAN) 52. Such networking 
environments are commonplace in office networks, enterprise-wide computer 
15 networks, intranets and the Internal, which are all types of networks. 

When used in a LAN-networking environment, the computer 20 is 
connected to the local network 5 1 through a network interface or adapter 53, 
which is one type of communications device. When used in a WAN-networking 
environment, the computer 20 typically includes a modem 54, a type of 
2 0 communications device, or any other type of communications device for 

establishing communications over the wide area network 52, such as the Internal. 
The modem 54, which may be internal or external, is connected to the system 
bus 23 via the serial port interface 46, In a networked environment, program 
modules depicted relative to the personal computer 20, or portions thereof, may 
25 be stored in the remote memory storage device. It is appreciated that the 
network connections shown are exemplary and other means of and 
communications devices for establishing a communications link between the 
computers may be used. 
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The hardware and operating environment in conjunction with which 
embodiments of the invention may be practiced has been described. The 
computer in conjunction with which embodiments of the invention may be 
practiced may be a conventional computer, a distributed computer, or any other 
5 type of computer, the invention is not so limited. Such a computer typically 
includes one or more processing units as its processor, and a computer-readable 
medium such as a memory. The computer may also include a communications 
device such as a network adapter or a modem, so that it is able to 
communicatively couple other computers. 

10 System 

Referring next to FIG. 2, a diagram of a system in accordance with an 
embodiment of the invention is shown. The system includes a database 200, a 
SCC system 202, a mechanism 204, and an editor 206. The system may be 
implemented over one or more computers, such as that described in the 

15 preceding section of the detailed description. In the case where the system is 
implemented over more than one computer, it may be implemented in what is 
known as a client-server architecture, or in what is known as a distributed 
system. The invention is not limited to a particular architecture, however, for the 
implementation of the system of FIG. 2. 

2 0 The database 200 may be any type of database, such as a SQL database 

known in the art. The database 200 stores records, or data, and also code, such 
as stored procedures as have been described in the background section. One 
such stored procedure is shown as stored procedure 208, which is a binary 
stream including a compiled part 210 and a text part 212 (those of ordinary skill 

25 within the art can appreciate that the part 210 and the part 212 can in another 

embodiment be stored as separated streams). The text part 212 acts as the source 
code of the compiled part 210. Those of ordinary skill within the art can 
appreciate, however, that the text part 212 may not be present, such that only the 
compiled part 210 is present. 
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The SCC system 202 stores versions of stored procedures, such as the 
stored procedure 208 stored in the database 200, and the stored procedure 214. 
The stored procedure 2 1 4 also has a compiled part 216 and a text part 2 1 8. Like 
the stored procedure 208, the text part 218 of the stored procedure 214 acts as the 
5 source code of the compiled part 216. Those of ordinary skill within the art can 
appreciate that the text part 218 may not be present, such that only the compiled 
part 216 is present. 

In one embodiment of the invention, the SCC system 202 is Visual 
Source Safe, from Microsoft Corp., which is a stand-alone product shipped as 

1 0 part of Visual Studio, a development environment for developing code such as 
stored procedures available from Microsoft Corp. The Visual Source Safe has 
OLE automation interfaces, as known in the art, for checking in and checking out 
different versions of code, such as stored procedures. The invention is not 
limited, however, to the embodiment utilizes Visual Source Safe and/or Visual 

15 Studio. 

The SCC system 202, as those of ordinary skill within the art can 
appreciate, is not limited to only handling database (e.g., SQL database) streams, 
but in other embodiments of the invention, can store other types of streams, such 
as including but not limited to: C code, Microsoft Word or other word processor 

2 0 documents, etc. 

Furthermore, "checking out" as referred to herein refers to the concept of 
tagging a given item such as a stored procedure such that the item is "in use" by 
a given user and otherwise cannot be edited or modified by another user 
(although this second user may be able to use a read-only version of the stored 

2 5 procedure), until the item has been checked back in. Thus, "checking in" as 
referred to herein refers to the concept of tagging a given item that has been 
previously checked out by a given user such that this user is finished modifying 
or editing the item such that other users are now able to check out the item for 
their own modification, editing, etc. 
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Thus, the SCC system 202 is able to store different versions of the same 
piece of code - such as different versions of the same stored procedure. When a 
stored procedure is checked out, for example, edited, saved to the database, and 
checked back in, the new version of the stored procedure is saved to the SCC 
5 system, in a manner that provides for the changes between the new version and 
the previous version or versions to be viewed. That is, a change or version 
history of a given stored procedure can be provided by the SCC system 202. 

The mechanism 204 is the manner by which a given stored procedure is 
actually checked into and out of the SCC system, so that the stored procedure of 

10 a database is not modified without versioning of the stored procedure taking 
place. Versioning is the process by which different versions of the stored 
procedure are kept track of, for example, by the SCC system 202. Thus, as 
shown in FIG. 2, a stored procedure of the database 200 cannot be accessed 
without the mechanism 204 knowing about the access, such that if modifications 

15 are made thereto, the mechanism 204 is able to indicate such changes as a new 
version of the stored procedure via the SCC system 202. In another 
embodiment, the database system 200 is itself able to invoke the mechanism 
204, on any read access to the stream 212, to provide the benefits of the 
invention to users who do not choose to use the editor 206 as the computer 

2 0 program used to manipulate the stream 212, as described in the next paragraph. 

The editor 206 is a specific type of a computer program that manipulates 
the stored procedures of the database 200. In particular, the editor 206 is a 
program that provides for the editing of the stored procedures of the database 
200. The invention is not so limited to a program that is an editor program, 

25 however — that is, the invention is amenable to any type of computer program 
that is used to manipulate database items such as stored procedures of the 
database 200. In one embodiment, the editor 206 is part of the Visual Studio 
development environment already described, such that the editor 206 includes a 
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"data view" of all the tables and the stored procedures, among other data and 
code, stored in the database 200. The invention is not so limited, however. 

The system of FIG. 2 operates as follows. The editor 206 desires to 
retrieve a stored procedure of the database 200 for editing and modification. 
5 Thus, the editor 206 requests to check out the stored procedure, such that the 
mechanism 204 checks out the desired stored procedure thereto. The mechanism 
204 does this as follows. It retrieves the stored procedure as stored in the 
database 200, as well as the same stored procedure as stored in the SCC system 
202. If the version of the stored procedure in the database 200 is the same as in 
1 0 the SCC system 202, then this version is provided to the editor 206. Otherwise, 
the editor 206 has the ability to choose from either version as the version it 
wishes to edit and modify. If it is the SCC system version, then this version is 
automatically saved to the database 200 as the database version, too, by the 
mechanism 204. Thus, the version of the stored procedure at the database 200 
1 5 can be either identical to or different than the version of the stored procedure at 
the SCC system 202. 

Once the editor 206 has edited and modified the stored procedure, it is 
saved to the database 200 as the database version of the stored procedure. This 
version is then retrieved by the mechanism 204 to check into the SCC system 
0 202 as the newest version of the stored procedure as saved by the SCC system 
202. In other words, the mechanism 204 checks in (i.e., saves) the stored 
procedure into the SCC system 200, checking in the stored procedure as has been 
saved to the database 200. 



different embodiments of the invention, are described. These methods can be 
performed, for example, by the mechanism 204 of the system of FIG. 2 that has 
been described in the preceding section, although the invention is not so limited. 
These computer-implemented methods are desirably realized at least in part as 



5 



Methods 

In this section, a check-out method and a check-in method, according to 
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one or more programs running on a computer — that is, as a program executed 
from a computer-readable medium such as a memory by a processor of a 
computer. The programs are desirably storable on a machine-readable medium 
such as a floppy disk or a CD-ROM, for distribution and installation and 
5 execution on another computer. 

Referring first to FIG. 3, a computer-implemented check-out method 
according to an embodiment of the invention is shown. The check-out method 
of FIG. 3 is a manner by which a stored procedure can be checked out from a 
SCC system, according to one embodiment. It may be performed, for example, 

10 when an editor or other program indicates to the mechanism that it wishes to 
edit or otherwise manipulate the stored procedure. In 300, the desired stored 
procedure is checked out from the SCC system - that is, it is indicated to the 
SCC system that the stored procedure is to be indicated as checked out. In 302, 
the SCC system version of the stored procedure stream is retrieved, and in 304, 

15 the database version of the stored procedure stream is retrieved. 

In 306, the SCC system version of the stored procedure stream is 
compared to the database version of the stored procedure stream. If they are the 
same, then the method is done at 308 - that is, the editor or other program can 
now conduct editing or other manipulation of the stored procedure. Otherwise, 

20 in 3 10, the user is asked to select either the SCC system version or the database 
version of the stored procedure stream. For example, this may be accomplished 
within the editor or other program that will be used to edit or otherwise 
manipulate the desired source procedure. If the database version is chosen, then 
the method proceeds from 312 to 308, and is done - that is, the editor or other 

2 5 program can now conduct editing or other manipulation of the stored procedure. 
Otherwise, in 314, the mechanism saves the SCC system version of the stored 
procedure stream to the database (such that the database version of the stored 
procedure stream is now the same as the SCC system version), and the method 
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also ends at 308, where the editor or other program can now conduct editing or 
other manipulation of the stored procedure. 

Once the editor or other program has finished its editing or other 
manipulation of the stored procedure, than the procedure must be checked back 
5 into the SCC system. This is accomplished by the method shown in FIG. 4. The 
method of FIG. 4 assumes that the stored procedure stream has already been 
saved by the editor or other program back to the database; however, the 
invention is not so limited - for example, this functionality can also be performed 
within the context of the method of FIG. 4, too. In 400, then, the stored 
1 0 procedure stream is retrieved by the mechanism, from the database (if the stream 
as modified or edited has not already been saved to the database, then this is first 
accomplished). 

Next, in 402, this version of the stored procedure stream is checked back 
into the SCC system. That is, the stored procedure stream is saved to the SCC 

15 system as the newest version of this stored procedure. Furthermore, the SCC 
system is also told to indicate that the stored procedure stream has now been 
checked in, such that it may be subsequently check out. In at least one 
embodiment of the invention, for example, a stored procedure stream cannot be 
checked out unless it is indicated in the SCC system as having been checked in - 

2 0 that is, two different programs cannot check out the same stored procedure 

stream at the same time. The invention is not so limited, however. The method 
of FIG. 4 ends at 404. 

Conclusion 

Versioning of stored procedures of databases has been described. 
2 5 Although specific embodiments have been illustrated and described herein, it 
will be appreciated by those of ordinary skill in the art that any arrangement 
which is calculated to achieve the same purpose may be substituted for the 
specific embodiments shown. For example, the specification has been described 
in relation to database items that are stored procedures, but the invention itself is 
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not so limited. This application is intended to cover any adaptations or 
variations of the present invention. For example, the invention can be used in 
relation to any type of database item, such as views, triggers, constraints, 
persisted queries and scripts for creating any database object, such as tables, 
5 indexes, domains, etc. Therefore, it is manifestly intended that this invention be 
limited only by the following claims and equivalents thereof. 
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What is claimed is: 

1 . A system comprising: 

a program to manipulate an item; 
5 a database having the item; 

a SCC system to store versions of the item; and, 
a mechanism to check in and check out the item. 

2. The system of claim 1, wherein the program comprises an editor program 
10 to edit the stored program. 

3. The system of claim 1, wherein the program requests to check out the 
item such that the mechanism checks out the item to the program. 

15 4. The system of claim 3, wherein the mechanism provides the program a 
choice of a version of the item at the SCC system and a version of the item at the 
database. 

5. The system of claim 4, wherein the version of the item at the SCC system 
20 is identical to the version of the item at the database. 

6. The system of claim 4, wherein the version of the item at the SCC system 
is different than the version of the item at the database. 

25 7. The system of claim 1 , wherein the program requests to check in the item 
such that the mechanism checks in the item into the SCC system. 

8, The system of claim 7, wherein the mechanism checks in the item into 
the SCC system as saved to the database. 
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9. The system of claim 1, wherein the database comprises a Structured 
Query Language (SQL) database. 

5 10. A computer-implemented method to check out an item from a SCC 
system comprising: 

comparing a stream of the item in the SCC system with a stream of the 
item in a database; 

determining whether the stream in the SCC system is identical to the 
10 stream in the database; and, 

upon determining that the stream in the SCC system is different than the 
stream in the database, providing a user a choice to select one of the stream in 
the SCC system and the stream in the database. 

15 11. The computer-implemented method of claim 1 0, further comprising prior 
to comparing, 

retrieving the stream of the item from the SCC system; and, 
retrieving the stream of the item from the database. 

20 12. The computer-implemented method of claim 10, wherein upon the user 
selecting the stream in the SCC system, saving the stream in the SCC system as 
the stream in the database. 

13. A computer-implemented method to check in an item into a SCC system 
25 comprising: 

retrieving a stream of the item from a database; and, 

saving the stream of the item in the database as the stream in the SCC 

system. 
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14. The computer-implemented method of claim 13, further comprising prior 
to retrieving, saving the stream of the item to the database. 

15. A computer-readable medium having instructions stored thereon for 
5 execution by a computer to perform a method comprising: 

comparing a stream of anitem in the SCC system with a stream of the 
item in a database; 

10 determining whether the stream in the SCC system is identical to the 

stream in the database; 

upon determining that the stream in the SCC system is different than the 

stream in the database, providing a user a choice to select one of the stream in 

the SCC system and the stream in the database; and, 
1 5 upon the user selecting the stream in the SCC system, saving the stream 

in the SCC system as the stream in the database. 

16. The computer-readable medium of claim 15, the method further 
comprising prior to comparing, 

2 0 retrieving the stream of the item from the SCC system; and, 

retrieving the stream of the item from the database. 

1 7. The computer-readable medium of claim 1 5, the method further 
comprising: 

2 5 retrieving a stream of the item from a database; and, 

saving the stream of the item in the database as the stream in the SCC 

system. 
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1 8. The computer-readable medium of claim 1 7, the method further 
comprising prior to retrieving, saving the stream of the item to the database. 
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